home *** CD-ROM | disk | FTP | other *** search
/ Desktop Publisher Plus / Desktop Publisher Plus (IBM-894)(Cosmi Corporation)(1992).img / README.TXT < prev    next >
Text File  |  1992-03-18  |  8KB  |  199 lines
  1.                 EDITING PRINTER DRIVERS
  2.                 -----------------------
  3.  
  4. Overview
  5. --------
  6.  
  7. This program includes a full screen editor, called BDE.EXE, for creating
  8.  and modifying the printer definitions in the file BDRV.PDT.  Chances are
  9.  that you will never need to use this editor.  It is included with this
  10.  software package primarily to support new printers which may be
  11.  manufactured after the release of this software package.  If you are
  12.  experiencing printer problems, then using this editor to add or edit a
  13.  printer definition should be a last resort - the first thing you should
  14.  try is selecting a different printer from the current options. For
  15.  instance, the Epson dot matrix and IBM graphics printers can be emulated
  16.  on most popular printers so you might try these printers. As a
  17.  precaution, you should always maintain an unmodified copy of BDRV.PDT on
  18.  a backup diskette.
  19.  
  20. Running the Editor
  21. ------------------
  22. To run the editor from the hard disk drive, change to the SWIFTDTP
  23.  subdirectory by typing "CD\SWIFTDTP" and press [Enter] at the DOS
  24.  prompt and then type "BDE" and press [Enter].
  25.  
  26. To run the editor from a floppy disk, copy both the file BDE.EXE from the
  27.  ART disk and the file BDRV.PDT from the program disk to a blank disk.
  28.  With the disk with the two files in the drive type "BDE" and press
  29.  [Enter]. When you are done editing copy the file BDRV.PDT back to the
  30.  program disk.
  31.  
  32. BDE operates at two levels, which are termed the 'table level' and the
  33.  'entry level'.  At the table level you deal with BDRV.PDT file as a
  34.  collection of device records without regard to record content.  You drop
  35.  tho the entry level by editing the device record for a particular
  36.  printer, and at that point the scope of the editor is just the current
  37.  device record.
  38.  
  39. Editing commands are selected via function keys, and there are separate
  40.  sets for each level.  Function key settings are always displayed across
  41.  the bottom of the editor screen in a separate window termed the prompt
  42.  window.  The remainder of the screen display is divided into three
  43.  addditional windows.  These are the title window, the list window, and
  44.  the edit window.
  45.  
  46. The title window extends across the top of the display, and contains three
  47.  items: (1) the program name, (2) the current printer number and the total
  48.  number of printers, and (3) the name of the PDT file currently being
  49.  edited.  The list window appears on the left and displays the printer
  50.  name from each device record.  The name list is scrollable, and the name
  51.  of the current printer is always highlighted.
  52.  
  53. The edit window fills the remainder of the screen.  It is empty until you
  54.  select the entry level, when all fields in the device record for the
  55.  current printer are displayed for editing.  You select the entry level by
  56.  pressing [Enter].  At that time you can modify the contents of the device
  57.  record.  You exit back to the table level by pressing [F10].  If you have
  58.  made changes to the record you will be prompted to retain or discard the
  59.  changes.
  60.  
  61. You exit the table level to DOS by pressing [F10] again. If the PDT has
  62.  been modified, you are prompted to save the changes to disk or to discard
  63.  the changes.
  64.  
  65. Table Level Functions
  66. ---------------------
  67.  
  68. At the table level the editor deals with the PDT as a whole, which can be
  69.  thought of as a collection of device records.  The following edit
  70.  commands, and the function keys that activate them, are available at this
  71.  level:
  72.  
  73.     [F1] - Help
  74.     [F2] - Print
  75.     [F4] - Find
  76.     [F5] - Sort
  77.     [F6] - Copy
  78.     [F7] - Add
  79.     [F8] - Delete
  80.  
  81. The Copy command (F6) allows you to copy the contents of one device record
  82.  into another.  The copy destination is the current device record (the one
  83.  highlighted in the editor list window) - its contents will be replaced by
  84.  the copy source record.  Once you select this function, a window is
  85.  opened that contains the same list of printers as the editor list window.
  86.   You highlight the desired source record and press [Enter].  The contents
  87.  of the selected source record are then copied to the current printer's
  88.  device record.
  89.  
  90. Entry Level Functions
  91. ---------------------
  92.  
  93. At the entry level the editor deals with the contents of a single device
  94.  record.  This level is selected by pressing [Enter] from the table level,
  95.  after which the contents of the current device record are displayed for
  96.  editing.  The following functions are available at this level:
  97.  
  98.     [F4] - Info
  99.     [F5] - Edit in HEXADECIMAL (base 16)
  100.     [F6] - Edit in DECIMAL (base 10)
  101.  
  102. [F4] - Info
  103. -----------
  104. This function provides context sensitive help for the cureent record
  105.  field.  A window is opened that displays a brief description of the field
  106.  and gives typical values for the field where appropriate.  Pressing any
  107.  key returns you to edit mode.
  108.  
  109. [F5] - Edit in HEXADECIMAL
  110. --------------------------
  111. This function opens a window with the current field value displayed as a
  112.  string of hexadecimal values.  You can edit individual characters by
  113.  modifying their numeric values.  As an example, suppose the reset-printer
  114.  escape sequence is "ESC@".  The field will be displayed as 
  115.  
  116.                 <-@
  117.  
  118. Pressing [F5] opens a window in which the field will be dsiplayed as
  119.  
  120.                 /1B/40
  121.  
  122. You can then typeover, insert, or delete characters. Deleting a digit
  123.  modifies the value of a character, but does not delete the character. 
  124.  Deleting the foreward slash (/) deletes the character, thus removing the
  125.  slash and the following numeric digits.
  126.  
  127. You may insert an new character by toggling the [Insert] key to insert
  128.  mode, and typing a hexidecimal value starting with the foreward slash
  129.  (e.g., typing /20 would insert a blank).  When you are finished editing,
  130.  press [Enter] to return to the Entry level.
  131.  
  132. Note that this function, and [F6] - Edit DECIMAL, are only selectable when
  133.  the current field is an escape sequence string.
  134.  
  135. [F6] - Edit DECIMAL
  136. -------------------
  137. This functions exactly like Edit HEX, except that values are displayed in
  138.  decimal instead of hexidecimal.
  139.  
  140. There is one pitfall that you should avoid when editing an escape
  141.  sequence, and it is more lekely to occur when using decimal mode.  It is
  142.  possible to insert or typeover a digit and create a numeric quantity
  143.  greater than 255, which cannot be represented as a single byte.  When
  144.  this happens, BDE truncates low order digits until the resulting value is
  145.  in range.
  146.  
  147. For example, assuming a character with a value of /123, if you typed over
  148.  the '1' and made it a '4', then the value that you would expect to see
  149.  would be /423.  However, BDE will drop the trailing '3' resulting in /42.
  150.  In effect, digits are pushed off of the trailing end of the character.
  151.  
  152.  
  153. Escape Sequence Variables
  154. -------------------------
  155. When editing escape sequences, you can imbed variable expressions within
  156.  them that are replaced with computed values at run time.  It is through
  157.  this mechanism that the printer driver handles quantities that are
  158.  required by a printer that can vary from one image to another.  The
  159.  format of an imbedded variable is
  160.         <vf>
  161.  
  162. where the angle brackets (< >) are required variable delimiters, 'v' is a
  163.  single letter specifying a variable name, and 'f' is a single character
  164.  specifying an output format.  The 'f' is optional and if omitted is
  165.  assumed to have the value 'A'.
  166.  
  167. The following table shows the variable symbols and the table after that
  168.  lists the valid format symbols.
  169.  
  170.     ----------------------------------------------------
  171.     Variable    Definition
  172.     ----------------------------------------------------
  173.     W        swath width in bytes
  174.     C        swath width in columns
  175.     R        resolution in dpi (dots per inch)
  176.     H        horizontal resolution dpi
  177.     V        vertical resolution dpi
  178.     M        horizontal mu (motion units)
  179.     U        vertical mu
  180.     X        horizontal cursor location
  181.     Y        vertical cursor location
  182.     S        swath count
  183.     N        row count
  184.     I        current swath number
  185.     P        current swath height in pins
  186.     B        number of bit planes
  187.     Q        row/color char (specific to Tektronix Color-Quick)
  188.  
  189.  
  190.     -----------------------------------------------------------
  191.     Format Char